home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_perl.idb / usr / freeware / catman / p_man / cat3 / ExtUtils::Install.Z / ExtUtils::Install
Encoding:
Text File  |  1998-10-28  |  4.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      EEEExxxxttttUUUUttttiiiillllssss::::::::IIIInnnnssssttttaaaallllllll((((222233333333))))////OOOOcccctttt////99998888    ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhhEEEE0000xxxx2222tttt))))UUUUttttiiiillllssss::::::::IIIInnnnssssttttaaaallllllll((((3333))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       ExtUtils::Install - install files from here to there
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       uuuusssseeee EEEExxxxttttUUUUttttiiiillllssss::::::::IIIInnnnssssttttaaaallllllll;;;;
  13.  
  14.       iiiinnnnssssttttaaaallllllll(((($$$$hhhhaaaasssshhhhrrrreeeeffff,,,,$$$$vvvveeeerrrrbbbboooosssseeee,,,,$$$$nnnnoooonnnnoooonnnnoooo))));;;;
  15.  
  16.       uuuunnnniiiinnnnssssttttaaaallllllll(((($$$$ppppaaaacccckkkklllliiiissssttttffffiiiilllleeee,,,,$$$$vvvveeeerrrrbbbboooosssseeee,,,,$$$$nnnnoooonnnnoooonnnnoooo))));;;;
  17.  
  18.       ppppmmmm____ttttoooo____bbbblllliiiibbbb(((($$$$hhhhaaaasssshhhhrrrreeeeffff))));;;;
  19.  
  20.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.       Both _i_n_s_t_a_l_l() and _u_n_i_n_s_t_a_l_l() are specific to the way
  22.       ExtUtils::MakeMaker handles the installation and
  23.       deinstallation of perl modules. They are not designed    as
  24.       general purpose tools.
  25.  
  26.       _i_n_s_t_a_l_l() takes three    arguments. A reference to a hash, a
  27.       verbose switch and a don't-really-do-it switch. The hash ref
  28.       contains a mapping of    directories: each key/value pair is a
  29.       combination of directories to    be copied. Key is a directory
  30.       to copy from,    value is a directory to    copy to. The whole
  31.       tree below the "from"    directory will be copied preserving
  32.       timestamps and permissions.
  33.  
  34.       There    are two    keys with a special meaning in the hash:
  35.       "read" and "write". After the    copying    is done, install will
  36.       write    the list of target files to the    file named by
  37.       $hashref->{write}. If    there is another file named by
  38.       $hashref->{read}, the    contents of this file will be merged
  39.       into the written file. The read and the written file may be
  40.       identical, but on AFS    it is quite likely, people are
  41.       installing to    a different directory than the one where the
  42.       files    later appear.
  43.  
  44.       _i_n_s_t_a_l_l__d_e_f_a_u_l_t() takes one or less arguments.  If no
  45.       arguments are    specified, it takes $ARGV[0] as    if it was
  46.       specified as an argument. The    argument is the    value of
  47.       MakeMaker's FULLEXT key, like    _T_k/_C_a_n_v_a_s. This    function calls
  48.       _i_n_s_t_a_l_l() with the same arguments as the defaults the
  49.       MakeMaker would use.
  50.  
  51.       The argumement-less form is convenient for install scripts
  52.       like
  53.  
  54.         perl -MExtUtils::Install -e    install_default    Tk/Canvas
  55.  
  56.       Assuming this    command    is executed in a directory with
  57.       populated _b_l_i_b directory, it will proceed as if the _b_l_i_b was
  58.       build    by MakeMaker on    this machine.  This is useful for
  59.       binary distributions.
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 10/23/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      EEEExxxxttttUUUUttttiiiillllssss::::::::IIIInnnnssssttttaaaallllllll((((222233333333))))////OOOOcccctttt////99998888    ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhhEEEE0000xxxx2222tttt))))UUUUttttiiiillllssss::::::::IIIInnnnssssttttaaaallllllll((((3333))))
  71.  
  72.  
  73.  
  74.       _u_n_i_n_s_t_a_l_l() takes as first argument a    file containing
  75.       filenames to be unlinked. The    second argument    is a verbose
  76.       switch, the third is a no-don't-really-do-it-now switch.
  77.  
  78.       _p_m__t_o__b_l_i_b() takes a hashref as the first argument and
  79.       copies all keys of the hash to the corresponding values
  80.       efficiently. Filenames with the extension pm are autosplit.
  81.       Second argument is the autosplit directory.
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 10/23/98)
  130.  
  131.  
  132.  
  133.